package com.jingdianjichi.oss.adapter;

import com.jingdianjichi.oss.entity.FileInfo;
import org.springframework.web.multipart.MultipartFile;

import java.io.InputStream;
import java.util.List;

/**
 * Description:
 * Copyright: Copyright (c) 2024
 * Create Time: 2024-07-19 14:21
 *
 * @author wanglianyun
 */
public interface StorageAdapter {

    /**
     * 创建bucket桶
     * @param bucket 桶名称
     * @throws Exception 异常
     */
    void createBucket(String bucket);

    /**
     * 上传文件
     * @param uploadFile 输入流
     * @param bucket 桶名称
     * @param objectName 对象名称
     * @throws Exception 异常
     */
    void uploadFile(MultipartFile uploadFile, String bucket, String objectName);

    /**
     * 列出所有桶
     * @return 所有桶名称
     * @throws Exception 异常
     */
    List<String> getAllBucket();

    /**
     * 列出当前桶及文件
     * @param bucket 桶名称
     * @return 当前桶信息
     * @throws Exception 异常
     */
    List<FileInfo> getAllFile(String bucket);

    /**
     * 下载文件
     * @param bucket 桶名称
     * @param objectName 对象名称
     * @return 返回文件信息
     * @throws Exception 异常
     */
    InputStream downLoad(String bucket, String objectName);

    /**
     * 删除桶
     * @param bucket 桶名称
     * @throws Exception 异常
     */
    void deleteBucket(String bucket);

    /**
     * 删除文件
     * @param bucket 桶名称
     * @param objectName 对象名称
     * @throws Exception 异常
     */
    void deleteObject(String bucket, String objectName);

    /**
     * 获取文件url
     * @param bucketName 桶名称
     * @param objectName 对象名称
     * @return 返回
     * @throws Exception 异常
     */
    String getPreviewFileUrl(String bucketName, String objectName);

    /**
     * 获取文件路径
     * @param bucket bucket
     * @param objectName objectName
     * @return 路径
     */
    String getUrl(String bucket, String objectName);
}
